<html>
<head>
	<title>Searching</title>
	
	<link rel="stylesheet" type="text/css" href="reference.css">
</head>
<body>

	<!-- navigation header start -->
	<table width="100%">
	   <tr>
	      <!-- back --><td width="50px"><a href="preferences_en.html">Prev</a></td>
	      <!-- home --><td style="text-align:center;"><b>Searching and Search Folders</b></td>
	      <!-- next --><td width="50px;" style="text-align:right;"><a href="enclosures_en.html">Next</a></td>
	   </tr>
	</table>
	<hr />
	<!-- navigation header end -->
	
	<h4>Searching for Feed Content</h4>

	<p>
	Liferea supports a simple case sensitive text searching in the item
	content and titles of all your subscriptions.
	</p>
	<p>
	To open the search 
	dialog click the search button in the toolbar.
	Enter the string you want to search for and click the "Search" button.
	Any items containing the string either in their title or their content 
	should appear in the resulting item list. Also the item content view
	will give you a message about the number of matches.
	</p>	

	<p align="center">
	<img src="help_search_1.4.0.png">
	</p>
	
	<h4>Permanent Searches with Search Folders</h4>

	<p>
	If you want to have permanent searches (e.g. all items containing
	the term "XML") you can create a search folder which will be added to
	your feed list and contains all items matching this search rule.
	To do so enter your search term into the search box and click
	the search button. After the results appear click the "Search Folder"
	button to create a search folder from the search results. Now a search
	folder should appear in your feed list. If you want you can edit the
	search folders title or change its rules by opening the properties
	dialog either from the "Subscriptions" menu or the contextual 
	menu in the feed list.
	<!-- FIXME add vfolder icon -->
	</p>

	<p align="center">
	<img src="help_vfolder_1.4.0.png">
	</p>

	<p>
	The following table is a list of all possible vfolder rules
	and their specific meaning.
	</p>

	<table border="1" cellpadding="3" style="border:1px solid black;border-collapse:collapse">
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb" width="50%">
	<b>Item does contain</b>
	</td><td>
	<b>Adds</b> each item whose title or content matches the given case insensitive string to the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Item does not contain</b>
	</td><td>
	<b>Removes</b> each item whose title or content matches the given case insensitive string from the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb">
	<b>Item title does contain</b>
	</td><td>
	<b>Adds</b> each item whose item title matches the given case insensitive string to the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Item title does not contain</b>
	</td><td>
	<b>Removes</b> each item whose item title matches the given case insensitive string from the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb">
	<b>Item body does contain</b>
	</td><td>
	<b>Adds</b> each item whose item content matches the given case insensitive string to the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Item body does not contain</b>
	</td><td>
	<b>Removes</b> each item whose item body matches the given case insensitive string from the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb">
	<b>Feed title does contain</b>
	</td><td>
	<b>Adds</b> each item whose parent feed's title matches the given case insensitive string to the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Feed title does not contain</b>
	</td><td>
	<b>Removes</b> each item whose parent feed's title matches the given case insensitive string from the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb">
	<b>Read status is unread</b>
	</td><td>
	<b>Adds</b> each unread item to the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Read status is read</b>
	</td><td>
	<b>Removes</b> each unread item from the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb">
	<b>Flag status is flagged</b>
	</td><td>
	<b>Adds</b> each flagged item to the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Flag status is unflagged</b>
	</td><td>
	<b>Removes</b> each flagged item from the vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#bfb">
	<b>Podcast included</b>
	</td><td>
	<b>Adds</b> all items that contain an enclosure to the search vfolder.
	</td></tr>
	<!-- ----------------------------------------- -->
	<tr><td style="background:#fbb">
	<b>Podcast not included</b>
	</td><td>
	<b>Removes</b> all items that do not contain an enclosure from the vfolder.
	</td></tr>
	</table>

	<p>
	Please note that the order of the rules does not matter. An additive
	rule after a removal rule that does match an item that is to be removed
	because of to the removal rule will not add this item!
	</p>

	<!-- navigation footer start -->
	<hr />
	<table width="100%">
	   <tr>
	      <!-- back --><td width="50px"><a href="preferences_en.html">Prev</a></td>
	      <!-- home --><td style="text-align:center;"><a href="topics_en.html">Contents</a></td>
	      <!-- next --><td width="50px;" style="text-align:right;"><a href="enclosures_en.html">Next</a></td>
	   </tr>
	</table>
	<!-- navigation footer end -->
</body>
</html>
